home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro223 / general.txt < prev    next >
Encoding:
Text File  |  1993-10-14  |  10.6 KB  |  262 lines
  1.                *************************
  2.                * General Documentation *
  3.                *************************
  4.  
  5.                PocketD Plus v3.1 (D.EXE)
  6.  
  7.       Directory Listing, Copy and File Management Program
  8.     PocketD (TM) Copyright Jeff Rollason, PocketWare (TM) 1990-1993
  9.               All Rights Reserved
  10.  
  11.  
  12.  Contents:
  13.  
  14.     (1) PocketD Plus and Shareware
  15.         ASP
  16.         Shareware
  17.         PocketD Plus
  18.         Disclaimers
  19.         Trademarks
  20.  
  21.     (2) Special Tips and Speeding up PocketD
  22.  
  23.     (3) Design Compromises
  24.  
  25.     (4) Compatibility and Limitations
  26.  
  27.  
  28.  (1) >>>>> PocketD Plus and Shareware
  29.  
  30.  PocketD Plus is a shareware product. You may use the software for free
  31.  for  30  days.  If you  continue  to use it after this time  you  must
  32.  register it through PocketWare (See below).
  33.  
  34.              _______
  35.             ____|__     |               (R)
  36.          --|       |    |-------------------
  37.            |   ____|__  |  Association of
  38.            |  |       |_|  Shareware
  39.            |__|   o   |    Professionals
  40.          -----|   |   |---------------------
  41.               |___|___|    MEMBER
  42.  
  43.  
  44.  Jeff   Rollason   is  a  member  of  the  Association   of   Shareware
  45.  Professionals  (ASP).  ASP  wants  to  make sure  that  the  shareware
  46.  principle   works   for  you.  If  you  are  unable   to   resolve   a
  47.  shareware-related  problem with an ASP member by contacting the member
  48.  directly,  ASP  may be able to  help. The ASP Ombudsman can  help  you
  49.  resolve  a dispute or problem with an ASP member, but does not provide
  50.  technical  support  for  members'  products. Please write to  the  ASP
  51.  Ombudsman  at  545  Grover  Road,  Muskegon, MI  USA  49442-9427,  FAX
  52.  616-788-2765,  or send a CompuServe message via CompuServe Mail to ASP
  53.  Ombudsman 70007,3536.
  54.  
  55.              ****************************
  56.              *  The Shareware Principle *
  57.              ****************************
  58.  
  59.  Software  distrubuted  as Shareware allows  the user to try out  fully
  60.  working programs before buying.
  61.  
  62.  >>>>> THIS IS THE IDEAL WAY TO BUY SOFTWARE:
  63.  
  64.     It  has the benefit of giving users the chance to fully try out
  65.     whether a product is suitable for their needs without risking a
  66.     wasted  financial  outlay. The  software is also CHEAPER!  (See
  67.     below).
  68.  
  69.  >>>>> THIS IS THE IDEAL WAY TO SELL SOFTWARE:
  70.  
  71.     The  Shareware  Author  does  not  have the  overhead  of  high
  72.     advertising   or   distribution  costs,  as  the   product   is
  73.     self-promoting.  In consequence Shareware products can be  sold
  74.     at a lower price than conventional retailed software.
  75.  
  76.  >>>>> IS SHAREWARE SOFTWARE ANY GOOD?
  77.  
  78.     Yes!  The  proof  of  this  is  obvious.  Shareware  completely
  79.     dominates  many areas of software, such as file compression and
  80.     communications, where Shareware has lead the market.
  81.  
  82.  >>>>> IS IT FREE?
  83.  
  84.     No!  Much  time and effort  is required to turn  programs  into
  85.     polished and documented products. So if you seriously intend to
  86.     use a Shareware product, then support it!
  87.  
  88.  
  89.          ************************************
  90.          * The Shareware version of PocketD *
  91.          ************************************
  92.  
  93.  The  Shareware  version of  D.EXE has a built-in  Registration  banner
  94.  screen  that will appear whenever  the user accesses the full  on-line
  95.  manual,  also prompting the user to input a single digit between 1 and
  96.  4  to acknowledge the banner.  The same banner appears randomly 3%  of
  97.  the  time  whenever  D.EXE  is  run,  waiting  for any  key  input  or
  98.  continuing  anyway after 60  seconds (It can therefore run  unattended
  99.  during evaluation). MENUD.EXE has a similar mechanism.
  100.  
  101.  You  are encouraged to freely  give this version away to other  users,
  102.  with  the proviso that it is not altered in any way, is supplied  with
  103.  all  the files detailed in the README.D file, is not supplied as  part
  104.  of  another system and no charge  is made for the program (unless  you
  105.  are  an  ASP approved vendor  or comply with the terms  stipulated  in
  106.  VENDOR.TXT).
  107.  
  108.             DISCLAIMER OF WARRANTY
  109.  
  110.  Users of PocketD must accept this disclaimer of warranty:
  111.  
  112.  "PocketD  is  supplied as  is.  The author disclaims  all  warranties,
  113.  expressed or implied, including, without limitation, the warranties of
  114.  merchantability  and of fitness for any purpose. The author assumes no
  115.  liability  for damages, direct or consequential, which may result from
  116.  the use of PocketD."
  117.  
  118.                   TRADEMARKS
  119.  
  120.  All  trademarks  are acknowledged.  This and other  related  documents
  121.  refer to the following names, among others:
  122.  
  123. - OS/2 & PC-DOS are trademarks of International Business Machines Corp.
  124.   (IBM Inc.)
  125. - LIST  copyrighted by Vernon D. Buerg
  126. - Microsoft, Windows & MSDOS registered trademarks of the Microsoft Corp.
  127. - DIET  Written by Teddy Matsumoto
  128. - PKlite, PKzip, PKARC and PKPAK  trademarks of PKWARE Inc.
  129. - LZEXE copyrighted by Fabrice Bellard
  130. - ANARKEY copyrighted by Steve Calwas of Moderne Software
  131. - CED   Written by Christopher J. Dunford
  132. - NORTON trademark of Peter Norton
  133. - PCTOOLS copyrighted by Central Point Software, Inc.
  134. - LHA & LHARC copyrighted by H. Yoshizaki
  135. - ZOO   copyrighted program
  136. - ARC & SEA  copyrighted by SEA
  137. - ARJ   copyrighted by Robert K. Jung
  138. - DESQview copyrighted by Quarterdeck
  139. - 4DOS  copyrighted by J.P. Software
  140. - Novell NetWare copyright Novell
  141. - CompuServe registered trademark of CompuServe Inc.
  142.  
  143.  
  144.  (2) >>>>> Special tips and Speeding up PocketD
  145.  
  146.     PocketD  is intended for use from the command line. The user is
  147.     strongly  recommended  to use it  with one of the many  command
  148.     history  editors  such as CED  or ANARKEY. This will allow  the
  149.     user  to experiment with long command lines without needing  to
  150.     re-type command input.
  151.  
  152.     DOS  constrains the user to  inputing lines no longer than  128
  153.     characters  long.  This  is  a  serious constraint  when  using
  154.     multi-line  or  multiple  templates  or very large  numbers  of
  155.     filespecs.  A  way around  this  constraint is to make  use  of
  156.     user-defined parameters to build long lines. e.g.
  157.  
  158.         set a1=[echo Creating $n//md $n//pkunzip $w $n\]
  159.         set a2=[?Unpack ZIP file to its own subdir ?]
  160.  
  161.     which  could be used by  the following line to generate a  long
  162.     command  line that could not have been entered within a  single
  163.     line.
  164.         d programs.zip game*.zip util*.zip /- *temp  /a1 /a2
  165.  
  166.     Another solution to processing large numbers of files is to use
  167.     a "response" file, e.g.
  168.  
  169.         d <list [pkzip -m backup $w]R
  170.  
  171.     where  "list"  is a file  of any size containing the  filenames
  172.     (and paths) to be processed.
  173.  
  174.     Since  PocketD  (D.EXE)  can  be  slow  to  load and  run,  it
  175.     is  recommended   that  it  is   run  from  a ram disk   (e.g.
  176.     VDISK   or RAMDRIVE).  To further improve the  load speed,  the
  177.     user can  also aliase D to D:D (where D: is the ram drive).
  178.  
  179.     OS/2 Users! --> Look at the compatibility notes.
  180.  
  181.  
  182.  
  183.  (3) >>>>> Design Compromises
  184.  
  185.     PocketD could have been designed differently.
  186.  
  187.     Many of its features could be expanded and made more exotic and
  188.     powerful.  For  example the  file viewer could  allow  wildcard
  189.     searches. D.EXE could make use of expanded memory and shell out
  190.     to  extended memory or  disk when running other programs.  File
  191.     copying could be made faster by buffering multiple files before
  192.     beginning a copy.
  193.  
  194.     All  these are possible, but if implemented, the tiny 29.6k  of
  195.     the  (registered) D.EXE program would be much bigger, and  less
  196.     attractive to those who want D.EXE to be as small as possible.
  197.  
  198.     D.EXE  has  been carefully  designed to provide an  astonishing
  199.     range  of features within a truly tiny program. This has  meant
  200.     that  its  facilities  have  had  to be closely  integrated  to
  201.     achieve  the maximum utility for each code section added.  This
  202.     design  approach  has  been  very successful. D.EXE  cannot  be
  203.     completely  replaced  by any  other combination of  tool  sets,
  204.     despite  its small size. The program that does come closest  to
  205.     D.EXE in functionality has less than half the range of options,
  206.     but is over twice the size.
  207.  
  208.     One  particular  compromise  is  the  design of  the  directory
  209.     browser.  This traverses  subdirectories by re-invoking  D.EXE.
  210.     This  has the effect of limiting how deep the user can  browse,
  211.     only  about  9 levels on a  normal machine (or 8 if  called  by
  212.     MENUD).  It also imposes  limits on the screen refresh  between
  213.     levels  and the speed of traversing levels. The payoff has been
  214.     the   very  small  code  size  increase  to  D.EXE,  also   the
  215.     compensation  of  the  useful  and unique ability of  D.EXE  to
  216.     search  for and collect any group of files and directories from
  217.     multiple drives to be browsed within a single list.
  218.  
  219.     The  final compromise is the single letter option names, giving
  220.     parameter  strings  that are  often  hard to read. This  was  a
  221.     deliberate  decision to allow the user to combine large numbers
  222.     of  options without hitting the 128 byte command limit. In  the
  223.     long run, most users will also appreciate the reduced number of
  224.     keystrokes needed to input a command.
  225.  
  226.     Does PocketD provide the right things?
  227.  
  228.     I believe it does. PocketD 1.67 was developed from the feedback
  229.     of  just a few users. v3.X has been developed from the feedback
  230.     from a much wider base, including reviewers and many registered
  231.     users,  and in consequence has been able to grow into a product
  232.     that closely satisifies the needs of a much more diverse group.
  233.  
  234.  
  235.  (4) >>>>> Compatibility and Limitations.
  236.  
  237.     .PocketD  works  under  MS-DOS/PC-DOS 3.0 or later,  Windows 3,
  238.      OS/2  and  DESQview.  However,  moving files  between  logical
  239.      drives  under OS/2 v2.0 will not work, because v2.0 has a  bug
  240.      which  prevents inter-drive moves in a DOS window from working
  241.      at  all. This may be fixed in v2.1. Users can safely speed  up
  242.      MOVE  within a drive by using the /.4 switch to turn off  OS/2
  243.      copy/move compatibility.
  244.  
  245.     .PocketD  will  work  with  non-standard  display  sizes,  e.g.
  246.      132x44.  Note that DOS's ANSI.SYS does not, and may  therefore
  247.      prevent PocketD (and DIR) from working correctly.
  248.  
  249.     .PocketD  can scan any number  of files and directories but  is
  250.      limited  to building lists  of about 1,400 names (except  when
  251.      using  /r or /e which can process any number). The  registered
  252.      version includes DL.EXE which can handle 10,000 names (PocketD
  253.      can generate lists of unlimited length with the line "D /j").
  254.  
  255.     .PocketD  needs  COMMAND.COM  to  be  available  when   running
  256.      external programs. It is strongly recommended that COMMAND.COM
  257.      is    made    resident    using   a   line   of    the    form
  258.      SHELL=C:\COMMAND.COM /p /e:1024  in CONFIG.SYS. This  provides
  259.      additional  environment  space,  which  PocketD  can  use  for
  260.      configuration, color and user-defined parameters.
  261.  
  262.